home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / raytrace / sirds / readme.1st < prev    next >
Text File  |  1993-10-16  |  6KB  |  139 lines
  1.  
  2.                     SirdView by Gary W. Shaw II
  3.                     ---------------------------
  4. LEGAL:
  5.  
  6.     These two programs are free and you are able to distribute them freely
  7.     as you wish as long as you keep this and all associated files together.
  8.     These are in the Public Domain and therefore you are not able to charge
  9.     for them in any way. The author of these programs makes no claims as to
  10.     completeness, nor does he give any warranty, or claim that they are "Bug
  11.     Free" in any way whatsoever. Now with that out of the way...
  12.  
  13. DESCRIPTION:
  14.  
  15.     Hello out there all you SIRDS fans! For those of you that are not
  16.     familar with SIRDS( Single Image Random Dot Stereograms) here is
  17.     a quick description:
  18.  
  19.         SIRDS are an optical illusion of sorts. They are a 3D image
  20.         hidden from plain sight by a random dot pattern. The 3D image
  21.         can be seen when your eyes converge to what is known as
  22.         Wall-eyed. This can be accomplished in a number of ways, but
  23.         the most common with programs like this is to put two points
  24.         on the screen and then you zone out on the dots untill you 
  25.         see three dots, the two dots converge in a center dot, and 
  26.         now there is three. At this point the SIRDS will appear.
  27.     
  28.     Well here is a couple of little programs for the PC that will allow
  29.     you to convert PCX pictures to sirds pictures. This is a very limited
  30.     utility. It can only work with images that are 640x480x256 color PCX
  31.     images. The reason I chose this is because it is a good resolution on
  32.     the PC, and it is 72 DPI, which will make it easier for people with
  33.     Macs to view sirds also. I will probably write a Mac viewer shortly.
  34.  
  35.     There are two programs included with this package:
  36.  
  37.         SirdView.exe - This is the conversion utility that translates
  38.                     PCX Images to my raw format (see below for 
  39.                     description). And in this new version it also
  40.                     outputs a monochrome PCX format.
  41.  
  42.         ViewSird.com - This just displays the raw .srd files.
  43.  
  44.     The SirdView utility may take a while depending on your computer.
  45.     It will continuely update the screen after each line with a '.' to
  46.     let you know what it is doing. This should be 6 full lines of .'s 
  47.     for the image. So if your computer is not doing anything and you don't
  48.     see anything on the screen at all then chances are your toasted, reboot.
  49.  
  50.     The ViewSird utility will read in a .srd file and display it. 
  51.  
  52. HELP:
  53.  
  54.     Both programs have help available by type either [program name] /? or
  55.     by just typing [program name] without any parameters.
  56.  
  57. FILES:
  58.  
  59.     Here is a list of the associated files.
  60.  
  61.     //The main conversion utility
  62.     SIRDVIEW.EXE Standard PC version no FP
  63.     FP386_SV.EXE Floating Point 386 version
  64.  
  65.     //the viewer
  66.     VIEWSIRD.COM Standard raw viewer
  67.  
  68.     //sample images
  69.     TEST.SRD        Sep 21,1993  08:17:08  38400 Image = "This is a Test."
  70.     WEAVE.SRD        Oct 10,1993  02:52:36  38400 Image = a wooven pattern
  71.     CIRCLES.SRD    Sep 21,1993  00:41:48  38400 Image = Circles in a circle
  72.     COLORS.SRD    Sep 21,1993  23:26:58  38400 Image = DPIIE palette/depth map
  73.     RAMP.SRD        Sep 22,1993  22:00:32  38400 Image = ramp up from left
  74.     NEWMYAN.SRD    Sep 22,1993  22:37:54  38400 Image = A Myan pyramid from top
  75.  
  76.     //this file
  77.     README.1ST
  78.  
  79.     The program sirdview takes a PCX file and then creates a raw monochrome
  80.     *file from that. The file will automatically have the extension .srd
  81.     If you have another file with that filename then it WILL be overwritten.
  82.     The format for the file is very simple. It is a packed byte of monochrome
  83.     pixels. The same way as the monochrome display is laid out. Refer to your
  84.     EGA or VGA manuals for info on what this is if you don't know.
  85.  
  86.     The depth information is taken from the PCX input file by the position
  87.     each color in the image is in the palette. I.E. color 0 is shallow and
  88.     color 255 is deepest. Some paint programs don't display the palette in
  89.     the same order, I have included the palette mapping for DPaint II E in 
  90.     the file "COLORS.SRD" this is a grid of 16x16 boxes drawn in each color.
  91.     If you are having problems with figuring out color/depth mapping with
  92.     your paint program I suggest you draw a picture similar to this and see
  93.     what happens when you display it as a SIRDS.
  94.  
  95.     *NOTE: Now it also outputs a Monochrome PCX file. This file will be
  96.     named the same as the input file but with a Dollar sign at the end.
  97.     i.e. sirdview myfile.pcx
  98.     output: myfile.pc$
  99.     This was done so that you can give the new myfile.pc$ a name that 
  100.     will not overwrite any of your input PCX files. Also because I was
  101.     to lazy to write the code to check for a unique name for the output
  102.     file.
  103.  
  104. FUTURE:
  105.  
  106.     I will probably be writing some more utilities like this one in the 
  107.     future if the popularity of SIRDS continues. Also if I get enough
  108.     feedback about these I will write more. I am interested to know what
  109.     features people are interested in and which platforms are most desired.
  110.     I have access to 3 platforms right now so it would have to be one of 
  111.     those, they are PC,MAC,UNIX. Also is Windows a consideration or not?
  112.  
  113.     If you have any other paint program color/depth mappings send them to
  114.     me and I will include them in future updates.
  115.  
  116.     If anyone is interested in putting a front end on this thing let me know
  117.     and maybe we can colaborate on it together.
  118.  
  119. AUTHOR:
  120.  
  121.     I am a cross platform developer for the PC and Mac platforms for an
  122.     entertainment (movie industry) software company. I program mainly in
  123.     'C++'. This version was written in 'C' since there wasn't much to it.
  124.     If you need to get in touch with me about this or just want to drop
  125.     me a line and let me know how bad this thing sucks then I'm at:
  126.  
  127.         garyshaw@netcom.com - Internet address
  128.  
  129.     And remember, don't play with your SIRDS to long...you'll go blind.
  130.  
  131.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  132.     Joke, you won't really go blind, I hope.
  133.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  134.  
  135. CHANGES:
  136.  
  137.     10/16/93 - Added support to output monochrome PCX files.
  138.  
  139.